package com.ruoyi.knowledge.service;

import java.util.List;
import org.springframework.web.multipart.MultipartFile;
import com.ruoyi.knowledge.domain.KnowledgeFile;

/**
 * 知识库文件Service接口
 * 
 * @author ruoyi
 */
public interface IKnowledgeFileService 
{
    /**
     * 查询知识库文件
     * 
     * @param id 知识库文件主键
     * @return 知识库文件
     */
    public KnowledgeFile selectKnowledgeFileById(Long id);

    /**
     * 查询知识库文件列表
     * 
     * @param knowledgeFile 知识库文件
     * @return 知识库文件集合
     */
    public List<KnowledgeFile> selectKnowledgeFileList(KnowledgeFile knowledgeFile);

    /**
     * 根据知识库ID查询文件列表
     * 
     * @param knowledgeId 知识库ID
     * @return 知识库文件集合
     */
    public List<KnowledgeFile> selectKnowledgeFilesByKnowledgeId(Long knowledgeId);

    /**
     * 新增知识库文件
     * 
     * @param knowledgeFile 知识库文件
     * @return 结果
     */
    public int insertKnowledgeFile(KnowledgeFile knowledgeFile);

    /**
     * 修改知识库文件
     * 
     * @param knowledgeFile 知识库文件
     * @return 结果
     */
    public int updateKnowledgeFile(KnowledgeFile knowledgeFile);

    /**
     * 批量删除知识库文件
     * 
     * @param ids 需要删除的知识库文件主键集合
     * @return 结果
     */
    public int deleteKnowledgeFileByIds(Long[] ids);
    
    /**
     * 批量删除知识库文件
     * 
     * @param ids 需要删除的知识库文件主键列表
     * @return 结果
     */
    public int deleteKnowledgeFileByIds(List<Long> ids);

    /**
     * 删除知识库文件信息
     * 
     * @param id 知识库文件主键
     * @return 结果
     */
    public int deleteKnowledgeFileById(Long id);
    
    /**
     * 删除知识库下的所有文件
     * 
     * @param knowledgeId 知识库ID
     * @return 结果
     */
    public int deleteKnowledgeFilesByKnowledgeId(Long knowledgeId);
    
    /**
     * 上传知识库文件
     * 
     * @param knowledgeId 知识库ID
     * @param file 文件
     * @param username 上传用户
     * @return 知识库文件信息
     */
    public KnowledgeFile uploadFile(Long knowledgeId, MultipartFile file, String username) throws Exception;
    
    /**
     * 处理文件向量化
     * 
     * @param fileId 文件ID
     * @return 结果
     */
    public int processFile(Long fileId);
} 